home *** CD-ROM | disk | FTP | other *** search
/ Delphi Magazine Collection 2001 / Delphi Magazine Collection 20001 (2001).iso / DISKS / Issue25 / compress / COMPRESS.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1997-07-09  |  10.0 KB  |  246 lines
  1.                TCompress Component Set V3.5
  2. File and Database Compression Components for Delphi and C++ Builder
  3.  
  4.   Copyright (c) 1995-97  South Pacific Information Services Ltd
  5.         Fax: +64-3-384-5138  Email: software@spis.co.nz
  6.          Web:  http://www.spis.co.nz/compress.htm
  7.  
  8. >>>>> If you ordered the registered version of TCompress, see REGINFO.TXT
  9.  
  10. These components are fully functional SHAREWARE.
  11.  
  12. You are encouraged to pass them on, upload them to BBS, Web and 
  13. ftp sites and generally spread them around as much as you can
  14. -- but please keep all the files together!
  15.  
  16. If you find TCompress useful, registration will get you the
  17. latest version, a personal ID to eliminate the occasional
  18. reminder message, access to our highly regarded (and, I have
  19. to say it, rarely needed) support AND a nice warm
  20. fuzzy feeling.
  21.  
  22. Registration details are at the end of this file.
  23.  
  24. ===== ALSO SEE COMPRESS.HLP AND FAQ.TXT FOR MUCH MORE INFORMATION =====
  25.  
  26. 1. Key features:
  27.  
  28. * Standard support for Delphi 1.0, 2.0, 3.0 and C++ Builder
  29. * NATIVE compression -- no mucking about with DLLs, OCXes et al
  30. * Multi-file compressed archives using the TCompress component
  31. * Database BLOB (memo, image) compression with TCDBMemo,
  32.   TCDBimage and (for Delphi 3.0 only) TCDBRichText
  33. * In-memory compression using streams
  34.   (file/memory/blob/resource<-->file/memory/blob)
  35. * Event hooks for customizable user interaction
  36. * Built-in RLE (Run-Length Encoding) and LZH5
  37.   (Lempel-Ziv-Huffman) compression
  38. * Easy to add your own custom compression routines at any time
  39. * Functions and examples to support compressed resources
  40.   and self-extracting EXEs
  41. * CompressString and ExpandString utility methods
  42. * Key-based compressed data encryption
  43. * Loads of example source included
  44. * Full component source code available
  45.  
  46.  
  47. 2. Quick Installation
  48.    (This is for experienced people in a hurry. For detailed instructions,
  49.     DO see the Installation section of COMPRESS.HLP, *especially*
  50.     Delphi 3 users! Also see the File List below for more details).
  51.  
  52. *   Unzip the appropriate DnDCUS.ZIP file (e.g. D3DCUS.ZIP is
  53.     for Delphi 3.0, OBJS.ZIP is for C++ Builder)
  54. *   Delphi 1.0/2.0: install COMPRESS.DCU and COMPCTRL.DCU
  55.     into your component library
  56. *   Delphi 3.0: Install the Compdb30.dpk package into your
  57.     component library  (File|Open|Compdb30.dpk, Compile|Install)
  58. *   C++ Builder: Install COMPRESS.OBJ/HPP and COMPCTRL.OBJ/HPP
  59.      into your component library
  60. *   Load the COMPDEMO project, compile and run it (if you are
  61.     using Delphi 1.0, see the notes at the top of COMPMAIN.PAS)
  62. *   Examine COMPMAIN.PAS for numerous examples of how to use
  63.     the compression components
  64.  
  65. Note: TCompress and its companions provide very comprehensive
  66. data compression capabilities. Most developers might only need
  67. to drop a TCompress component on their form and call its ExpandFile/CompressFile
  68. methods in order to create and work with their own multi-file archives...
  69.  
  70. Others might drop TCDBMemo/TCDBImage/TCDBRichText components
  71. on as well and simply interact with them to have text and picture data
  72. automatically compressed when they are stored in a database.
  73.  
  74. ...and some developers might use the TCBlobfield class to store all kinds
  75. of data (sound, numbers, video etc) directly into compressed database blobs
  76. -- see the BLOB.DPR (BLOB.MAK for C++) demonstration for an example of this.
  77.  
  78.  
  79. 3.  Installing Help -- see the Installation section of COMPRESS.HLP
  80.  
  81.  
  82. 4. File list:
  83.  
  84. D1DCUs.ZIP     Delphi 1.0 DCU and DCR files (and a Delphi 1.0 copy of BLOBDEMO.DFM)
  85. D2DCUs.ZIP     Delphi 2.0 DCU and DCR files
  86. D3DCUs.ZIP     Delphi 3.0 DCU and DCR files and DPK package source
  87. OBJS.ZIP       C++ Builder OBJ, HPP, DCU and DCR files, and MAK/CPP files
  88.                to go with each of the Pascal demonstration projects below
  89.  NB: if you downloaded our COMP_NOC.ZIP archive, the OBJS.ZIP file is not present,
  90.    -- download COMPRESS.ZIP from our Web site to get the full file set.
  91.  
  92. ***within each of the above files, you'll find:
  93. COMPRESS.DCU   TCompress component
  94. COMPRESS.DCR   Component palette icon for TCompress
  95.  
  96. COMPCTRL.DCU   TCDBImage, TCDBMemo and TCDBRichText (Delphi 3.0 only)
  97. COMPCTRL.DCR   Component palette icons for the above
  98.  
  99. * D3DCUS.ZIP only:
  100. COMPDB30.DPK   Delphi 3.0 package source for ALL TCompress components
  101. COMP30.DPK     Delphi 3.0 package source for TCompress component only -- no
  102.                BDE dependencies
  103.  
  104. * OBJS.ZIP only:
  105. COMPRESS.OBJ/HPP C++ object and include files for Compress,
  106. COMPONLY.OBJ/HPP Componly
  107. COMPCTRL.OBJ/HPP and Compctrl units
  108.            *.MAK C++ project files for each of the DPR projects
  109.                  noted below
  110.  
  111. * D1DCUS.ZIP only:
  112. BLOBDEMO.DFM   Delphi 1 version of the form in the main archive
  113.  
  114. ***remaining files in main archive:
  115. COMPRESS.HLP   Complete help file for TCompress component set
  116. COMPRESS.KWF   Keyword file to integrate into Delphi 1.0/2.0's help
  117.  
  118. COMPDEMO.DPR   TCompress demonstration project file
  119. COMPMAIN.PAS   Source for the above (many examples here!)
  120. COMPMAIN.DFM   Form for the above
  121.  
  122. BLOB.DPR       Example project for storing miscellaneous
  123. BLOBDEMO.PAS   data (e.g. arrays, sound, AVI etc) in a
  124. BLOBDEMO.DFM   compressed database blob. See comments
  125.                at the top of BLOBDEMO.PAS.
  126.  
  127. RLECOMP.PAS    Example source showing how to implement a custom
  128.                compression handler (for RLE in this case)
  129.  
  130. ARC2MEM.PAS    Example of expanding data directly from an
  131.                archive to memory (drops into COMPMAIN.PAS)
  132.  
  133. ARC2BLOB.PAS   Example of copying compressed data directly
  134.                from a file archive to a  compressed blob
  135.                WITHOUT expanding it first (drops into COMPMAIN)
  136.  
  137. SELFEXTR.DPR   Example projects for creating self-extracting
  138. SELFEXTF.PAS   archives -- in one case with a form providing
  139. SELFEXTF.DFM   a user interface, in the other with minimum
  140. DOINSTAL.PAS   possible overhead by using no form.
  141. SELFXSML.DPR   Both projects tested with Delphi 2.0/3.0 only.
  142. COMP_RES.RC
  143.  
  144. BMTEST.DPR     Example project for storing and loading
  145. BMTESTF.PAS    compressed bitmaps from EXE or DLL resources
  146. BMTESTF.DFM    instead of using external archives or
  147. BITMAPS.RC     regular (uncompressed) resources
  148.  
  149. HISTORY.TXT    Development history
  150. FAQ.TXT        Have a look at the Contents, at the very least!
  151. README.TXT     This file
  152.  
  153.  
  154. 5. Synopsis (for Web/BBS listings etc):
  155.  
  156. Filename: COMPRESS.ZIP   (File date: 10-July-97  Time: 3:50)
  157. 1 line description:
  158. TCompress v3.5 File and Database Compression Components for Delphi & C++ Builder
  159. Uploader name & email: Peter Hyde, software@spis.co.nz
  160. Surface address: SPIS Ltd PO Box 19-760, Christchurch, NEW ZEALAND
  161. Special requirements: Any version of Delphi or C++ Builder
  162. Shareware payment required from private users: $NZ90 (about $US65)
  163. Source included: No (available separately)
  164. Size zipped / original (in Kb): 294/477
  165.  
  166. Brief description:
  167.  
  168. TCompress provides native components for the creation of 
  169. multi-file compressed archives, as well as database, file,
  170. resource and in-memory compression using streams.
  171. Three compression methods (RLE, LZH and LZH5) are built in, with
  172. "hooks" for the easy addition of custom compression formats.
  173.  
  174. TCompress also includes drop 'n play components for automatic
  175. database blob, image, rich text and memo compression, based on the
  176. VCL's TDBMemo, TDBRichText and TDBImage components.
  177.  
  178. Images compress by up to 99% when using LZH, hence there is a
  179. massive saving in disk space and disk or network access when
  180. using these components.
  181.  
  182. TCompress comes with an extensive demonstration, many source
  183. examples and comprehensive help and keyword files. Supports
  184. Delphi 1.0, 2.0, 3.0 and C++ Builder.
  185.  
  186.  
  187. 6. Registration
  188.  
  189. *** No upgrade fee for users of TCompress v3.0 or later.
  190. If you are a registered user of an earlier TCompress version, please see
  191. the special upgrade pricing in the Registration section of COMPRESS.HLP.
  192.  
  193. Full registration information and a handy form are in COMPRESS.HLP.
  194. When you register, you will receive an updated version (if any), and
  195. a personal registration ID to eliminate the occasional reminder dialog.
  196.  
  197. On registration, you can optionally also order the source code
  198. of the TCompress component (COMPRESS.PAS) and/or the
  199. TCDBImage/TCDBMemo/TCDBRichText components (COMPCTRL.PAS).
  200. Please specify when ordering if you also want these.
  201.  
  202. Registration prices:
  203.  
  204. Product Registration/License: $NZ90 (about $US65)
  205. Optional Compress source (add): $NZ59 (about $US40)
  206. Optional Compctrl source (add): $NZ49 (about $US34)
  207. Optional airmailed disk  (add): $NZ10 (no charge if emailed)
  208.  
  209. Payments may be made by Mastercard or Visa (please specify card 
  210. number, expiry date, and name of holder). You may also pay by a
  211. bank check in your own currency to the equivalent value at
  212. current exchange rates. We do NOT accept Compuserve SWREG
  213. registrations.
  214.  
  215. Please print or email the form in COMPRESS.HLP to register
  216. your version.
  217.  
  218. Contact: SPIS Ltd, PO Box 19-760, Christchurch, New Zealand
  219. Fax: +64-3-384-5138           Email: software@spis.co.nz
  220.  
  221.  
  222. **** Other components you should check out:
  223.  
  224. * TSegCompress by Ken McClain (kmcclain@mindspring.com).
  225. TSegCompress builds on TCompress to allow you to create segmented archives,
  226. e.g. for saving one archive onto several floppies.
  227.  
  228. Download from http://www.mindspring.com/~kmcclain/index.htm
  229.  
  230. * TCompLHA LHarc/LHA Archive Manager
  231. Whereas TCompress is crafted to handle a wide range of
  232. general-purpose compression tasks, TCompLHA is specifically
  233. tailored to create and manage archives compatible with the
  234. popular freeware LHArc and LHA utilities (these archives are also
  235. compatible with other utilities like WinZip). TCompLHA can also
  236. read TCompress multi-file archives. An exceptionally easy interface
  237. gives you maximum results with almost no development effort, but
  238. powerful event hooks are provided to give you full control if needed.
  239.  
  240. Download from: http://www.spis.co.nz/compLHA.htm
  241.  
  242.  
  243. *** For late-breaking information, new versions, new components, tips and tricks,
  244.  visit our Web page at
  245. http://www.spis.co.nz/compress.htm
  246.